入门

快速设置 Rust 开发环境并编写一个小应用程序!

安装 Rust

您可以在 Rust 游乐场中在线尝试 Rust,无需在您的计算机上安装任何内容。

无需安装即可尝试 Rust

Rustup:Rust 安装程序和版本管理工具

人们安装 Rust 的主要方式是通过一个名为 Rustup 的工具,它是一个 Rust 安装程序和版本管理工具。

看起来您正在运行 macOS、Linux 或其他类 Unix 操作系统。要下载 Rustup 并安装 Rust,请在您的终端中运行以下命令,然后按照屏幕上的说明进行操作。如果您使用的是 Windows,请参阅 "其他安装方法"

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

看起来您正在运行 Windows。要开始使用 Rust,请下载安装程序,然后运行该程序并按照屏幕上的说明进行操作。在提示时,您可能需要安装 Visual Studio C++ 构建工具。如果您不在 Windows 上,请参阅 "其他安装方法"

适用于 Linux 的 Windows 子系统

如果您是适用于 Linux 的 Windows 子系统用户,请在您的终端中运行以下命令,然后按照屏幕上的说明安装 Rust。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Rust 可以在 Windows、Linux、macOS、FreeBSD 和 NetBSD 上运行。如果您使用的是这些平台之一,并且看到了此消息,请使用以下值报告问题

navigator.platform: MacIntel
navigator.appVersion: 5.0 (Macintosh)


报告问题

要安装 Rust,如果您运行的是 Unix,

请在您的终端中运行以下命令,然后按照屏幕上的说明进行操作。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

如果您运行的是 Windows,

请下载并运行 rustup‑init.exe,然后按照屏幕上的说明进行操作。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

如果您运行的是 Windows,

请下载并运行 rustup‑init.exe,然后按照屏幕上的说明进行操作。



Rust 是否已更新?

Rust 更新非常频繁。如果您在一段时间前安装了 Rustup,您的 Rust 版本很可能已过时。通过运行 rustup update 获取最新版本的 Rust。



了解有关安装的更多信息

Cargo:Rust 构建工具和包管理器

安装 Rustup 时,您还将获得最新稳定版本的 Rust 构建工具和包管理器,也称为 Cargo。Cargo 可以执行许多操作

  • 使用 cargo build 构建您的项目
  • 使用 cargo run 运行您的项目
  • 使用 cargo test 测试您的项目
  • 使用 cargo doc 为您的项目构建文档
  • 使用 cargo publish 将库发布到 crates.io

要测试您是否已安装 Rust 和 Cargo,您可以在您选择的终端中运行以下命令

cargo --version

阅读 Cargo 手册

其他工具

许多编辑器都提供 Rust 支持

生成新项目

让我们使用新的 Rust 开发环境编写一个小应用程序。首先,我们将使用 Cargo 为我们创建一个新项目。在您选择的终端中运行

cargo new hello-rust

这将生成一个名为 hello-rust 的新目录,其中包含以下文件

hello-rust
|- Cargo.toml
|- src
  |- main.rs

Cargo.toml 是 Rust 的清单文件。您可以在其中保存项目的元数据以及依赖项。

src/main.rs 是我们编写应用程序代码的地方。


cargo new 步骤为我们生成了一个“Hello, world!”项目!我们可以通过进入我们创建的新目录并在终端中运行以下命令来运行此程序

cargo run

您应该在终端中看到以下内容

$ cargo run
   Compiling hello-rust v0.1.0 (/Users/ag_dubs/rust/hello-rust)
    Finished dev [unoptimized + debuginfo] target(s) in 1.34s
     Running `target/debug/hello-rust`
Hello, world!

添加依赖项

让我们向我们的应用程序添加一个依赖项。您可以在 crates.io(Rust 的包注册表)上找到各种库。在 Rust 中,我们通常将包称为“crate”。

在此项目中,我们将使用一个名为 ferris-says 的 crate。

在我们的 Cargo.toml 文件中,我们将添加以下信息(我们从 crate 页面获取)

[dependencies]
ferris-says = "0.3.1"

我们也可以通过运行 cargo add ferris-says 来执行此操作。

现在我们可以运行

cargo build

...Cargo 将为我们安装依赖项。

您将看到运行此命令为我们创建了一个新文件 Cargo.lock。此文件记录了我们本地使用的依赖项的确切版本。

要使用此依赖项,我们可以打开 main.rs,删除其中的所有内容(它只是另一个示例),并向其中添加以下行

use ferris_says::say;

此行表示我们现在可以使用 ferris-says crate 为我们导出的 say 函数。

一个小型的 Rust 应用程序

现在让我们使用新的依赖项编写一个小应用程序。在我们的 main.rs 中,添加以下代码

use ferris_says::say; // from the previous step
use std::io::{stdout, BufWriter};

fn main() {
    let stdout = stdout();
    let message = String::from("Hello fellow Rustaceans!");
    let width = message.chars().count();

    let mut writer = BufWriter::new(stdout.lock());
    say(&message, width, &mut writer).unwrap();
}

保存后,我们可以通过键入以下命令来运行应用程序

cargo run

如果一切顺利,您应该看到应用程序将以下内容打印到屏幕上

 __________________________
< Hello fellow Rustaceans! >
 --------------------------
        \
         \
            _~^~^~_
        \) /  o o  \ (/
          '_   -   _'
          / '-----' \

了解更多!

您现在是 Rustacean 了!欢迎!我们很高兴您加入。准备好后,请访问我们的学习页面,您可以在其中找到许多书籍,帮助您继续您的 Rust 之旅。

了解更多!

这只螃蟹是谁,费里斯?

费里斯是 Rust 社区的非官方吉祥物。许多 Rust 程序员称自己为“Rustacean”,这是“甲壳类动物”一词的变体。我们用任何代词来指代费里斯,“她”、“他”、“他们”、“它”等等。

费里斯这个名字源于形容词“ferrous”,意思是与铁有关的。由于 Rust 通常在铁上形成,所以这似乎是我们吉祥物名字的一个有趣的起源!

您可以在 rustacean.net 上找到更多费里斯的图片。 费里斯左右移动的 GIF 图